Skip to content

doc: enhanced icon pack creation#8659

Open
hulmgulm wants to merge 6 commits intoTriliumNext:mainfrom
hulmgulm:main
Open

doc: enhanced icon pack creation#8659
hulmgulm wants to merge 6 commits intoTriliumNext:mainfrom
hulmgulm:main

Conversation

@hulmgulm
Copy link
Contributor

@hulmgulm hulmgulm commented Feb 8, 2026

When I was reading the icon pack creation page the first time, I was confused by the example. I did not understand how the manifest has to look like and what the other JSON is about. Also, I was not sure what to do with the script. I tried to make this page clearer to understand. Made a clearer separation between the general flow to generate an icon pack and the concrete example. I hope, it is ok

@dosubot dosubot bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Feb 8, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @hulmgulm, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on improving the user experience for creating custom icon packs by revamping the associated documentation. The changes aim to demystify the process, offering a more structured and intuitive guide from understanding supported formats to generating and integrating icon packs within the application. The goal is to make the documentation more accessible and less confusing for new and existing users.

Highlights

  • Documentation Clarity: The documentation for creating custom icon packs has been significantly enhanced for clarity, addressing previous confusion regarding manifest structure and script usage.
  • Quick Flow Guide: A new 'Quick flow' section has been introduced to provide a high-level, step-by-step overview of the icon pack creation process, making it easier for users to grasp the overall procedure.
  • Manifest Generation Script: The Node.js script example for generating the icon pack manifest has been improved to write the output directly to a 'manifest.json' file, along with clear instructions on how to use it.
  • Documentation Structure: The sections related to manifest format, prefix assignment, and creating the Trilium icon pack note have been reorganized and clarified for better logical flow and understanding.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • apps/server/src/assets/doc_notes/en/User Guide/User Guide/Basic Concepts and Features/Themes/Icon Packs.html
    • Fixed minor HTML formatting within an
    • tag.
  • apps/server/src/assets/doc_notes/en/User Guide/User Guide/Theme development/Creating an icon pack.html
    • Added a 'Quick flow' section to outline the icon pack creation steps.
    • Clarified the 'Manifest format' section with a detailed example and explanatory notes.
    • Updated the Node.js script to output the manifest to 'manifest.json' and included usage instructions.
    • Restructured the 'Creating the icon pack' section, renaming it to 'Creating the Trilium icon pack note' and moving prefix assignment details to a dedicated section.
    • Added a step to rename the note when creating the Trilium icon pack note.
    • Adjusted the final steps for adding the #iconPack label.
  • docs/Developer Guide/Developer Guide/Documentation.md
    • Updated an image reference within the documentation.
  • docs/User Guide/!!!meta.json
    • Swapped internalLink values, likely correcting a documentation link reference.
  • docs/User Guide/User Guide/Theme development/Creating an icon pack.md
    • Introduced a 'Quick flow' section for a high-level overview of the process.
    • Revised the 'Manifest format' section with a clearer example and additional explanatory notes.
    • Updated the Node.js script to write to 'manifest.json' and provided explicit usage instructions.
    • Reorganized the steps for 'Creating the icon pack', establishing a dedicated 'Creating the Trilium icon pack note' section and integrating prefix assignment details.
Activity
  • The author, hulmgulm, initiated this pull request to improve the clarity of the icon pack creation documentation, based on their personal experience of finding the original instructions confusing.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This is an excellent improvement to the icon pack creation documentation. Your changes make the process much clearer and easier to follow for new users. The separation of the general workflow from the concrete example, and the addition of the 'Quick flow' section, are particularly helpful. The updated Node.js script is also a great practical enhancement. Overall, this is a very valuable contribution to the documentation. I've just spotted a minor typo in one of the files.

hulmgulm and others added 2 commits February 8, 2026 10:45
…e development/Creating an icon pack.html

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
…pack.md

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant